package com.qsw.paper.service;

import com.qsw.paper.pojo.dto.CollegeDto;
import com.qsw.paper.pojo.dto.CollegeQueryDto;
import com.qsw.paper.pojo.entity.Colleges;
import com.baomidou.mybatisplus.extension.service.IService;
import com.qsw.paper.pojo.vo.CollegeStudentAndAdvisorCountVO;
import com.qsw.paper.pojo.vo.CollegeThesisPassRateVO;
import com.qsw.paper.result.PageResult;

import java.util.List;

/**
 * <p>
 * 服务类
 * </p>
 *
 * @author qsw
 * @since 2024-11-15
 */
public interface ICollegesService extends IService<Colleges> {

    /**
     * 添加学院
     *
     * @param collegeDto dto
     */
    void save(CollegeDto collegeDto);

    /**
     * 修改学院信息
     *
     * @param collegeDto dto
     */
    void update(CollegeDto collegeDto);

    /**
     * 删除学院
     *
     * @param id 学院id
     */
    void deleteById(Integer id);

    /**
     * 获取学院列表
     *
     * @param queryDto dto
     * @return 分页后的学院列表
     */
    PageResult<?> pageList(CollegeQueryDto queryDto);


    /**
     * 前7个学院下的论文通过率（近三个月）
     *
     * @return 数据列表
     */
    List<CollegeThesisPassRateVO> getCollegeThesisPassRate();

    /**
     * 获取前7个学院下的所有学生人数以及导师数量
     *
     * @return 数据列表
     */
    List<CollegeStudentAndAdvisorCountVO> getCollegeStudentAndAdvisorCount();

}
